Port SERVICEACCESS - ETHERNET-RAW

ETHERNET OSI layer 2 communication

Stimulation

此端口不具备激励能力。

Name

在以下情况下可用

默认值

有效值

Type

Description

Port

string

Name of the port inside a network. In Vector Hardware Config, the network-based mode must be activated.

Filter in BPF format

string

Specify a BPF filter

VLAN settings

‘no tagging’

[‘no tagging’, ‘single tagging’]

string

Used VLAN setting

VLAN-VID

1

int

Integer, only used if VLAN tagging is enabled

Receive buffer size

1000

int

Number of messages which can be recorded in the receive buffer (ring buffer)

Automatic data reception on test run

☑

bool

Only operative if on the left for ‘Start’ either ‘Always’ is chosen, or ‘If necessary’ and the port is in use in the test configuration.

Path / file name for the PCAP/PCAPNG output file

Automatic data reception on test run

string

PCAP or PCAPNG file (with absolute path). Recording is done into this file. Leave blank if no recording is desired.

Default source MAC address

‘02:00:4C:4F:4F:50’

string

Default MAC which will be used for ethernet frames.

Keep cyclic sending active

☐

bool

If checked, cyclic transmission of packets will be stopped during port stop, or by explicitly calling ‘StopSendPacketCyclic’. Otherwise (default) cyclic transmission will be stopped when test case execution finishes.

Leave PTP active

☐

bool

若勾选,则仅在配置关闭时或显式调用 ‘StopPtpMaster/Client’ 时才停止 PTP。否则(默认),在 test case 执行结束后停止 PTP。

IP address

string

IP address of the port, will be replaced for [IP] in the filter string

ClearReceiveBuffer

Clears the ecu.test high-level receive buffer. Low-level buffers in the driver are not cleared.

GetLinkState

Returns the Link status of this Ethernet channel as provided by the XL interface

Parameterization

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

linkState

string

Possible values are:

None: “Channel Status” event not yet received from XL interface or last “Channel Status” event was malformed or connection to XL interface closed.

“down”: Link is down (e. g. no cable attached, not configured, remote station down).

“up”: Link is up.

“unknown”: Link status could not be determined (e. g. if connection to device is lost).

“error”: Link is in error state (e. g. auto-negotiation failed).

Playback

Plays back a PCAP or PCAPNG recording on the network adapter. The call returns immediately, the playback continues asynchronously.

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

PcapFile

uri

PCAP or PCAPNG file to play back: Absolute path or relative to the workspace.

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Identifier

int

Instance identifier that can be used for StopPlayback

ReceivePacket

Returns a packet from the receive buffer and removes it from there

Parameterization

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

result

string

Return value of type PacketEthernet or NotPresent

ReceiveSomeIpMessage

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

InterpretAs

string

MessageId

int

MultipleResults

False

[False, True]

bool

ResolveMac

Resolve MAC-address

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

EthSrcMac

‘Default’

string

String (format: 00:11:FF:1E:32:FF), leave ‘Default’ if the MAC from the port settings should be used

IpDst

‘192.168.0.1’

string

String (format: 192.168.0.1)

IpSrc

‘Default’

string

String (format: 192.168.0.1), leave ‘Default’ if the IP from the port settings should be used

SrcSubnetMask

‘Default’

string

Subnet mask for IP network (necessary for broadcast detection, e.g. ARP), leave Default for using the primary NIC subnet mask

VlanCfi

0

int

Integer, is only used if VLAN is configured

VlanPcp

0

int

Integer, is only used if VLAN is configured

VlanVid

‘Default’

string

Integer, Default if port setting should be used, only evaluated if VLAN is configured

SendPacket

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

EthDestMac

string

String (format: 00:11:FF:1E:32:FF), Default if MAC address is resolved over ARP or multicast calculation

EthernetData

string

String, payload as a ByteStream (e.g. ByteStream(“00:00”))

EthSrcMac

‘Default’

string

String (format: 00:11:FF:1E:32:FF), leave ‘Default’ if the MAC from the port settings should be used

EthSrcType

‘ETH_TYPE_IP’

[‘ETH_TYPE_8021AD’, ‘ETH_TYPE_8021Q’, ‘ETH_TYPE_AOE’, ‘ETH_TYPE_ARP’, ‘ETH_TYPE_CDP’, ‘ETH_TYPE_DTP’, ‘ETH_TYPE_EDP’, ‘ETH_TYPE_IP’, ‘ETH_TYPE_IP6’, ‘ETH_TYPE_IPX’, ‘ETH_TYPE_LLDP’, ‘ETH_TYPE_MPLS’, ‘ETH_TYPE_MPLS_MCAST’, ‘ETH_TYPE_PPP’, ‘ETH_TYPE_PPPoE’, ‘ETH_TYPE_PPPoE_DISC’, ‘ETH_TYPE_PROFINET’, ‘ETH_TYPE_PUP’, ‘ETH_TYPE_QINQ1’, ‘ETH_TYPE_QINQ2’, ‘ETH_TYPE_REVARP’, ‘ETH_TYPE_TEB’, ‘ETH_TYPE_UNKNOWN’]

string

String from selection or integer

VlanCfi

0

int

Integer, is only used if VLAN is configured

VlanPcp

0

int

Integer, is only used if VLAN is configured

VlanVid

‘Default’

string

Integer, Default if port setting should be used, only evaluated if VLAN is configured

StartPtpClient

启动 PTP 客户端功能。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

ClockIdentity

int

消息字段:ClockIdentity

CorrectionNs

0

int

消息字段:CorrectionNs

DestMac

‘01:80:c2:00:00:0e’

string

目标 MAC 地址

DomainNumber

int

报文字段:DomainNumber

HwTsOffsetNs

0

int

要加到所有硬件时间戳上的偏移量。

LogMessagePeriod

0

int

消息字段:LogMessagePeriod

RequestIntervalNs

1000000000

int

发送 PeerDelayRequest 消息的间隔。

SequenceCounterFreeze

False

[False, True]

bool

防止 SC 递增。

SequenceCounterInit

0

int

序列计数器的初始值

SourceMac

string

源 MAC 地址

SourcePortId

int

消息字段:SourcePortId

StartPtpMaster

启动 PTP master 功能。必须先为该端口启动数据接收!

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

ClockIdentity

int

消息字段:ClockIdentity

CorrectionNs

0

int

消息字段:CorrectionNs

CumulativeScaledRateOffset

0

int

消息字段:CumulativeScaledRateOffset

DestMac

‘01:80:c2:00:00:0e’

string

目标 MAC 地址

DomainNumber

int

报文字段:DomainNumber

FupDelayNs

0

int

Sync 与 FollowUp 报文之间的最小时间间隔

GmTimebaseIndicator

0

int

消息字段:GmTimebaseIndicator

HwTsOffsetFupNs

0

int

要加到 FollowUp 消息硬件时间戳上的偏移量。

HwTsOffsetNs

0

int

要加到所有硬件时间戳上的偏移量。

HwTsOffsetPeerDelayResponseFupNs

0

int

要加到 PeerDelayResponseFollowUp 消息的硬件时间戳上的偏移量。

HwTsOffsetPeerDelayResponseNs

0

int

要加到 PeerDelayResponse 消息的硬件时间戳上的偏移量。

LastGwPhaseChange

0

int

报文字段:LastGwPhaseChange

LogMessagePeriod

0

int

消息字段:LogMessagePeriod

PeerDelayResponseFupDelayNs

0

int

PeerDelayResponse 与 FollowUp 消息之间的最小时间间隔

ScaledLastGmFreqChange

0

int

消息字段:ScaledLastGmFreqChange

SendFup

True

[False, True]

bool

发送 FollowUp 消息。

SendPeerDelayResponse

True

[False, True]

bool

发送 PeerDelayResponse 与 FollowUp 报文。

SendPeerDelayResponseFup

True

[False, True]

bool

发送 PeerDelayResponseFollowUp 消息。

SequenceCounterFreeze

False

[False, True]

bool

防止 SC 递增。

SequenceCounterFupOffset

0

int

Sync 与 FollowUp SequenceCounter 之间的偏移量。

SequenceCounterInit

0

int

序列计数器的初始值

SequenceCounterPeerDelayResponseFupOffset

0

int

PeerDelayRequest 与 ResponseFollowUp SequenceCounter 之间的偏移。

SequenceCounterPeerDelayResponseOffset

0

int

PeerDelayRequest 与 Response SequenceCounter 之间的偏移。

SourceMac

string

源 MAC 地址

SourcePortId

int

消息字段:SourcePortId

SyncIntervalNs

125000000

int

发送同步消息的间隔。

StartReceiving

Starts manual data receiving

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

FilterString

string

Specify a BPF filter

PcapFileName

string

PCAP or PCAPNG file (with absolute path). Recording is done into this file. Leave blank if no recording is desired.

VlanVid

‘Default’

string

Integer, Default if port setting should be used, only evaluated if VLAN is configured

StartSendPacketCyclic

Starts cyclic Transmission of a specified message

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

CycleTime

500

int

Cycle time [ms]

CyclicHandle

int

CyclicHandle can be defined manually. It must be an integer value greater than 0. Collision detection against already defined handles will not be performed.

Payload

object

Payload of the message to be sent cyclically. Either a byte stream can be specified directly or an object from a UserPyModule defined class. Further information on using the payload can be found in the help (Tool tracetronic: Ethernet).

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

CyclicHandle

int

Handle for targeted deactivation of cyclic transmission of that particular message.

StopPlayback

Stops playback of a PCAP/PCAPNG file

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Identifier

-1

int

Instance identifier returned by the “Playback” job call

StopPtpClient

停止 PTP 客户端功能

StopPtpMaster

停止 PTP 主站功能

StopReceiving

Stops data receiving manual

StopSendPacketCyclic

Stops cyclic transmission

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

CyclicHandle

int

Handle of a message to stop its cyclic transmission. If None is specified, cyclic transmission of all messages is stopped.

UpdatePtpClient

更新 PTP 客户端功能的参数。必须为该端口启动数据接收!

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

ClockIdentity

int

消息字段:ClockIdentity

CorrectionNs

0

int

消息字段:CorrectionNs

DestMac

‘01:80:c2:00:00:0e’

string

目标 MAC 地址

DomainNumber

int

报文字段:DomainNumber

HwTsOffsetNs

0

int

要加到所有硬件时间戳上的偏移量。

LogMessagePeriod

0

int

消息字段:LogMessagePeriod

RequestIntervalNs

1000000000

int

发送 PeerDelayRequest 消息的间隔。

SequenceCounterFreeze

False

[False, True]

bool

防止 SC 递增。

SequenceCounterInit

0

int

序列计数器的初始值

SourceMac

string

源 MAC 地址

SourcePortId

int

消息字段:SourcePortId

UpdatePtpMaster

更新 PTP master 功能的参数。必须先为该端口启动数据接收!

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

ClockIdentity

int

消息字段:ClockIdentity

CorrectionNs

0

int

消息字段:CorrectionNs

CumulativeScaledRateOffset

0

int

消息字段:CumulativeScaledRateOffset

DestMac

‘01:80:c2:00:00:0e’

string

目标 MAC 地址

DomainNumber

int

报文字段:DomainNumber

FupDelayNs

0

int

Sync 与 FollowUp 报文之间的最小时间间隔

GmTimebaseIndicator

0

int

消息字段:GmTimebaseIndicator

HwTsOffsetFupNs

0

int

要加到 FollowUp 消息硬件时间戳上的偏移量。

HwTsOffsetNs

0

int

要加到所有硬件时间戳上的偏移量。

HwTsOffsetPeerDelayResponseFupNs

0

int

要加到 PeerDelayResponseFollowUp 消息的硬件时间戳上的偏移量。

HwTsOffsetPeerDelayResponseNs

0

int

要加到 PeerDelayResponse 消息的硬件时间戳上的偏移量。

LastGwPhaseChange

0

int

报文字段:LastGwPhaseChange

LogMessagePeriod

0

int

消息字段:LogMessagePeriod

PeerDelayResponseFupDelayNs

0

int

PeerDelayResponse 与 FollowUp 消息之间的最小时间间隔

ScaledLastGmFreqChange

0

int

消息字段:ScaledLastGmFreqChange

SendFup

True

[False, True]

bool

发送 FollowUp 消息。

SendPeerDelayResponse

True

[False, True]

bool

发送 PeerDelayResponse 与 FollowUp 报文。

SendPeerDelayResponseFup

True

[False, True]

bool

发送 PeerDelayResponseFollowUp 消息。

SequenceCounterFreeze

False

[False, True]

bool

防止 SC 递增。

SequenceCounterFupOffset

0

int

Sync 与 FollowUp SequenceCounter 之间的偏移量。

SequenceCounterInit

0

int

序列计数器的初始值

SequenceCounterPeerDelayResponseFupOffset

0

int

PeerDelayRequest 与 ResponseFollowUp SequenceCounter 之间的偏移。

SequenceCounterPeerDelayResponseOffset

0

int

PeerDelayRequest 与 Response SequenceCounter 之间的偏移。

SourceMac

string

源 MAC 地址

SourcePortId

int

消息字段:SourcePortId

SyncIntervalNs

125000000

int

发送同步消息的间隔。